Solstar — Solar & Renewable Energy React Template
Built with React 19, Vite and React Router. No jQuery.
Version: 1.0.0 · Updated: October 2026 · Author: Mugli
1. Introduction
Solstar is a multi-page website template for solar, renewable-energy and green-technology companies. This package is the React edition: the original HTML design converted into reusable components, with client-side routing and a modern Vite build.
Features
- 12 ready pages: 3 home layouts, About, Services, Service Details, Projects, Project Details, Blog, Blog Details, FAQ, Contact, plus a 404 page
- React 19 + React Router 7, routes lazy-loaded for fast first load
- Zero jQuery. Scroll animations, counters, progress bars, tilt and video popup are written with React and standard browser APIs
- Swiper sliders and Splitting.js text animation installed from npm
- Responsive layout based on Bootstrap 5.3
- Sticky header, full-screen mobile menu, preloader, custom cursor, back-to-top button
- Configurable contact form (works with any form endpoint)
- Font Awesome Free icons (no paid license required)
- One-file theme colors through CSS variables
2. Package contents
| Item | Description |
|---|---|
solstar-react/ | The source code of the template (what you edit and build). |
documentation/ | This documentation. Open index.html in any browser. |
changelog.txt | Release history. |
Run all npm commands inside the solstar-react folder.
3. Requirements
| Tool | Version |
|---|---|
| Node.js | 20.19 or newer, or 22.12 or newer (required by Vite 8) |
| npm | 10 or newer (installed with Node.js) |
| Code editor | Any, e.g. VS Code |
Check your versions with node -v and npm -v. Download Node.js from nodejs.org.
4. Installation
1. Unzip the package and open a terminal in the solstar-react folder.
2. Install dependencies:
npm install
3. Start the development server:
npm run dev
Open the address shown in the terminal (usually http://localhost:5173). Changes you save appear instantly.
Available commands
| Command | What it does |
|---|---|
npm run dev | Development server with hot reload |
npm run build | Creates the production site in dist/ |
npm run preview | Serves the dist/ build locally to test it |
npm run lint | Checks the source code for problems |
5. Project structure
solstar-react/
├── index.html HTML shell: page meta, favicon, theme CSS links
├── vercel.json Rewrite rule so deep links work on Vercel
├── .env.example Environment variables (form endpoint)
├── package.json
├── vite.config.js
├── public/
│ └── assets/ Static files, served as-is
│ ├── css/ bootstrap.min.css, all.min.css (Font Awesome Free),
│ │ animate.css, main.css (theme styles)
│ ├── images/ Template images, grouped by section
│ ├── img/ Decorative shapes
│ └── webfonts/ Font Awesome font files
└── src/
├── main.jsx Entry point, imports Swiper / Splitting / Bootstrap JS
├── App.jsx Route table (lazy-loaded pages)
├── layouts/
│ └── MainLayout.jsx Shared chrome: preloader, header, mobile menu, cursor, etc.
├── components/
│ ├── Header.jsx, MobileMenu.jsx, Preloader.jsx
│ ├── BackToTop.jsx, Cursor.jsx, VideoModal.jsx, FormHandler.jsx
│ └── FooterHome1/2/3.jsx, FooterDefault.jsx
├── effects/
│ └── useTemplateEffects.js Scroll reveal, counters, progress, sliders, tilt, text split
├── pages/ One file per page
└── styles/
└── app.css Small additions (video modal, form toast)
6. Pages & routing
| URL | File |
|---|---|
/ | src/pages/HomeOne.jsx |
/home-two | HomeTwo.jsx |
/home-three | HomeThree.jsx |
/about | About.jsx |
/services | Services.jsx |
/service-details | ServiceDetails.jsx |
/projects | Projects.jsx |
/project-details | ProjectDetails.jsx |
/blog | Blog.jsx |
/blog-details | BlogDetails.jsx |
/faq | Faq.jsx |
/contact | Contact.jsx |
| any other URL | NotFound.jsx (404) |
Use <Link to="/about"> from react-router-dom for internal links so pages change without a reload.
Adding a new page
1. Create src/pages/Pricing.jsx. Copy an existing inner page such as Faq.jsx and edit it. Keep the outer smooth-wrapper / smooth-content divs and the footer.
import FooterDefault from "../components/FooterDefault";
export default function Pricing() {
return (
<div className="smooth-wrapper" id="smooth-wrapper">
<div className="smooth-content" id="smooth-content">
{/* your sections */}
<FooterDefault />
</div>
</div>
);
}
2. Register it in src/App.jsx:
const Pricing = lazy(() => import("./pages/Pricing"));
...
<Route path="/pricing" element={<Pricing />} />
3. Add it to the menus (see Navigation menu).
Scroll animations, sliders and counters on the new page start automatically. No extra setup is needed.
7. Components
| Component | Purpose |
|---|---|
MainLayout | Wraps every page. Renders the preloader, cursor, back-to-top, form handler, header and mobile menu, and scrolls to the top on navigation. |
Header | Desktop navigation and "Get a quote" button. Gets the sticky class after 10px of scrolling. |
MobileMenu | Slide-in menu for small screens. Menu items are defined in a MENU array at the top of the file. |
FooterHome1 / 2 / 3 | Footers used by Home One, Two and Three. |
FooterDefault | Footer used by all inner pages. |
VideoModal | Opens YouTube or Vimeo links in a popup. Any link with the class popup-video opens it automatically. |
FormHandler | Handles all forms. See Forms. |
Preloader, Cursor, BackToTop | Small self-contained interface pieces. |
8. Customization
Colors
Theme colors are CSS variables at the top of public/assets/css/main.css:
:root {
--theme: #004540; /* main brand color (dark green) */
--theme2: #FFE175; /* accent (yellow) */
--header: #241442; /* dark headings / hover */
--title: #252525; /* heading text */
--text: #525252; /* body text */
--orange: #F74F22;
--bg: #EAECF3;
--bg2: #EBEDE2;
...
}
Change a value once and it updates everywhere it is used.
Fonts
The theme uses Google Fonts: Jost, Epilogue, Poppins and Teko. They are loaded by @import lines near the top of main.css. To change a font, edit those lines and update the font-family values in the same file.
public/assets/fonts.Logo & favicon
| What | File |
|---|---|
| Header logo | public/assets/images/logo/headerLogo1_1.png (used in Header.jsx) |
| Mobile menu logo | public/assets/images/logo/logo2.svg (used in MobileMenu.jsx) |
| Footer logo | public/assets/images/logo/footerLogo1_1.png |
| Favicon | public/assets/images/favicon.png (linked in index.html) |
Replace the files with your own using the same names, or change the paths in the components.
Navigation menu
The menu exists in two places. Update both:
- Desktop: the
<nav className="main-menu">list insrc/components/Header.jsx - Mobile: the
MENUarray at the top ofsrc/components/MobileMenu.jsx
// MobileMenu.jsx
{ label: "Pricing", to: "/pricing" },
{ label: "Blog", submenu: [
{ to: "/blog", label: "Blog" },
{ to: "/blog-details", label: "Blog Details" },
] },
Footers
Edit the matching footer component to change text, links, address, phone, email and social icons. FooterDefault.jsx is shared by all inner pages, so one edit updates 9 pages.
Images
All images live in public/assets/images and are referenced with root paths such as /assets/images/about/aboutThumb1_1.png. Replace a file with the same name, or point the src to a new file. Keep images compressed (JPG/WebP for photos, SVG/PNG for icons) for faster loading.
Section background images are set with an inline style in the page files, for example style={{ backgroundImage: "url(/assets/images/service/serviceDetailsContactBG.jpg)" }}, or by CSS rules in main.css.
Page titles & SEO
Each page sets its browser-tab title in a useEffect at the top of the page file:
useEffect(() => {
document.title = "About Us — Solstar React Template";
}, []);
Default meta description, author and favicon are in index.html.
9. Animations & effects
All effects are started by useTemplateEffects() in src/effects/useTemplateEffects.js. You only add classes and attributes to your markup.
| Effect | How to use |
|---|---|
| Scroll reveal | Add wow plus an Animate.css class: className="wow fadeInUp". Optional delay: data-wow-delay=".3s", optional duration: data-wow-duration="1s". |
| Counter | <span className="counters-item">250</span> counts from 0 to the number when it scrolls into view. |
| Progress bar | <div className="progress-bar" style={{width: "75%"}} /> animates from 0 to the width. |
| Text split animation | Add data-splitting (with the theme's splt-txt wow classes) to a heading or paragraph. |
| Card tilt | Add data-tilt and optionally data-tilt-max={12} (degrees). |
| Video popup | <a href="https://www.youtube.com/watch?v=ID" className="popup-video"> |
| Accordion (FAQ) | Bootstrap collapse: data-bs-toggle="collapse" and data-bs-target="#id". |
Sliders
Any element with the classes swiper mugli-slider becomes a slider. Options are read from its data-slider-options attribute (JSON):
<div className="swiper mugli-slider"
data-slider-options='{"loop": true, "autoplay": false,
"breakpoints": {"0":{"slidesPerView":1},"768":{"slidesPerView":2},"1200":{"slidesPerView":3}}}'>
<div className="swiper-wrapper">
<div className="swiper-slide">Slide 1</div>
<div className="swiper-slide">Slide 2</div>
</div>
<div className="slider-pagination"></div>
<button className="slider-prev"></button>
<button className="slider-next"></button>
</div>
Defaults: 1 slide, loop on, 6 second autoplay, 1 second transition. Any Swiper option can be added to the JSON. Arrows use .slider-prev / .slider-next and dots use .slider-pagination inside the slider.
10. Forms
To receive messages, point the forms at any service that accepts a form POST (your own backend, Formspree, Getform, Basin, etc.):
1. Copy .env.example to .env.
2. Set your URL:
VITE_FORM_ENDPOINT=https://formspree.io/f/yourFormId
3. Restart npm run dev or rebuild with npm run build.
Form fields are sent as multipart/form-data using their name attributes. A success or error message appears at the bottom of the screen. Environment variables are read at build time, so rebuild after changing them.
11. Deployment
Run npm run build. Upload the contents of the dist folder to any static host. Because the site uses client-side routing, the server must return index.html for every URL; otherwise refreshing /about gives a 404.
Vercel
Import the project (framework preset: Vite). The included vercel.json already contains the needed rewrite.
Netlify
Create public/_redirects containing:
/* /index.html 200
Apache (.htaccess in the site root)
RewriteEngine On
RewriteBase /
RewriteRule ^index\.html$ - [L]
RewriteCond %{REQUEST_FILENAME} !-f
RewriteCond %{REQUEST_FILENAME} !-d
RewriteRule . /index.html [L]
Nginx
location / {
try_files $uri /index.html;
}
Sub-folder hosting
If the site is not at the domain root (for example example.com/solar/), set base: "/solar/" in vite.config.js and add basename="/solar" to <BrowserRouter> in App.jsx. Image paths that start with /assets/ also need that prefix.
12. Browser support
Latest versions of Chrome, Edge, Firefox, Safari (desktop and iOS) and Android Chrome. Internet Explorer is not supported.
13. Credits & licenses
Code libraries
| Library | License | Link |
|---|---|---|
| React, React DOM | MIT | react.dev |
| React Router | MIT | reactrouter.com |
| Vite | MIT | vite.dev |
| Bootstrap 5.3 | MIT | getbootstrap.com |
| Swiper | MIT | swiperjs.com |
| Splitting.js | MIT | splitting.js.org |
| Animate.css | MIT | animate.style |
Icons
Font Awesome Free 6 — icons CC BY 4.0, font files SIL OFL 1.1, code MIT. See fontawesome.com/license/free. The template does not include Font Awesome Pro.
Fonts
Jost, Epilogue, Poppins and Teko from Google Fonts, all under the SIL Open Font License 1.1.
Images
public/assets/images (for example stock site, photographer and URL). Envato requires that all images included in the download are licensed for redistribution.| Folder / file | Source | License |
|---|---|---|
public/assets/images/… | (add) | (add) |
14. Troubleshooting
| Problem | Solution |
|---|---|
npm install or npm run dev fails with an engine/version error | Upgrade Node.js to 20.19+ or 22.12+. |
Refreshing a page like /about shows 404 on my host | Add the rewrite rule for your server (see Deployment). |
| Form shows "Demo mode" message | Set VITE_FORM_ENDPOINT and rebuild (see Forms). |
Changed .env but nothing happens | Restart the dev server or rebuild. Variables are read at start/build time. |
| My new page has no animation | Add the wow class plus an Animate.css class such as fadeInUp. |
| A slider shows all slides in a column | Check the markup has the swiper mugli-slider classes on the container and swiper-wrapper / swiper-slide inside. |
| Icons appear as squares | Confirm public/assets/webfonts exists and was uploaded to the server. |
| A white or empty page after deploy | The site is probably in a sub-folder. See "Sub-folder hosting". |
15. Changelog
Version 1.0.0 — October 2026
- Initial release of the React edition
- 12 pages + 404, React 19, React Router 7, Vite 8
- jQuery removed; effects rebuilt with React and browser APIs
- Font Awesome Pro replaced with Font Awesome Free
- Configurable form endpoint (no third-party form action)
16. Support
Support covers questions about the template's features, reports of bugs, and help with included functionality. It does not cover custom development or third-party services.
Please contact the author through the item's comments page on the marketplace where you bought it, or the contact details on the author's profile. Include your Node.js version, the steps to reproduce the problem, and any message shown in the terminal or browser console.
If you like Solstar, a rating on the marketplace is greatly appreciated.